12 const callPackagelist = rpc.declare({
14 method: 'packagelist',
17 const callSystemBoard = rpc.declare({
22 const callUpgradeStart = rpc.declare({
24 method: 'upgrade_start',
29 * Returns the branch of a given version. This helps to offer upgrades
30 * for point releases (aka within the branch).
33 * SNAPSHOT -> SNAPSHOT
34 * 21.02-SNAPSHOT -> 21.02
35 * 21.02.0-rc1 -> 21.02
38 * @param {string} version
39 * Input version from which to determine the branch
41 * The determined branch
43 function get_branch(version) {
44 return version.replace('-SNAPSHOT', '').split('.').slice(0, 2).join('.');
48 * The OpenWrt revision string contains both a hash as well as the number
49 * commits since the OpenWrt/LEDE reboot. It helps to determine if a
50 * snapshot is newer than another.
52 * @param {string} revision
53 * Revision string of a OpenWrt device
55 * The number of commits since OpenWrt/LEDE reboot
57 function get_revision_count(revision) {
58 return parseInt(revision.substring(1).split('-')[0]);
63 init: [ 0, _('Received build request')],
64 container_setup: [ 10, _('Setting up ImageBuilder')],
65 validate_revision: [ 20, _('Validating revision')],
66 validate_manifest: [ 30, _('Validating package selection')],
67 calculate_packages_hash: [ 40, _('Calculating package hash')],
68 building_image: [ 50, _('Generating firmware image')],
69 signing_images: [ 95, _('Signing images')],
70 done: [100, _('Completed generating firmware image')],
71 failed: [100, _('Failed to generate firmware image')],
73 /* Obsolete status values, retained for backward compatibility. */
74 download_imagebuilder: [ 20, _('Downloading ImageBuilder archive')],
75 unpack_imagebuilder: [ 40, _('Setting Up ImageBuilder')],
78 request_hash: new Map(),
81 applyPackageChanges: async function(package_info) {
82 let { url, target, version, packages } = package_info;
84 const overview_url = `${url}/api/v1/overview`;
85 const revision_url = `${url}/api/v1/revision/${version}/${target}`;
87 let changes, target_revision;
90 request.get(overview_url)
91 .then(response => response.json())
92 .then(json => json.branches)
93 .then(branches => branches[get_branch(version)])
94 .then(branch => { changes = branch.package_changes; })
96 throw Error(`Get overview failed:<br>${overview_url}<br>${error}`);
99 request.get(revision_url)
100 .then(response => response.json())
101 .then(json => json.revision)
102 .then(revision => { target_revision = get_revision_count(revision); })
104 throw Error(`Get revision failed:<br>${revision_url}<br>${error}`);
108 for (const change of changes) {
109 let idx = packages.indexOf(change.source);
110 if (idx >= 0 && change.revision <= target_revision) {
112 packages[idx] = change.target;
114 packages.splice(idx, 1);
120 selectImage: function (images, data, firmware) {
121 var filesystemFilter = function(e) {
122 return (e.filesystem == firmware.filesystem);
124 var typeFilter = function(e) {
125 let efi_targets = ['armsr', 'loongarch', 'x86'];
126 let efi_capable = efi_targets.some((tgt) => firmware.target.startsWith(tgt));
129 return (e.type == 'combined-efi');
131 return (e.type == 'combined');
134 return (e.type == 'sysupgrade' || e.type == 'combined');
137 return images.filter(filesystemFilter).filter(typeFilter)[0];
140 handle200: function (response, content, data, firmware) {
141 response = response.json();
142 let image = this.selectImage(response.images, data, firmware);
144 if (image.name != undefined) {
145 this.sha256_unsigned = image.sha256_unsigned;
146 let sysupgrade_url = `${data.url}/store/${response.bin_dir}/${image.name}`;
148 let keep = E('input', { type: 'checkbox' });
153 `${response.version_number} ${response.version_code}`,
158 if (data.advanced_mode == 1) {
175 E('a', { href: sysupgrade_url }, _('Download firmware image'))
177 if (data.rebuilder) {
178 fields.push(_('Rebuilds'), E('div', { id: 'rebuilder_status' }));
181 let table = E('div', { class: 'table' });
183 for (let i = 0; i < fields.length; i += 2) {
185 E('tr', { class: 'tr' }, [
186 E('td', { class: 'td left', width: '33%' }, [fields[i]]),
187 E('td', { class: 'td left' }, [fields[i + 1]]),
197 E('label', { class: 'btn' }, [
200 _('Keep settings and retain the current configuration'),
203 E('div', { class: 'right' }, [
204 E('div', { class: 'btn', click: ui.hideModal }, _('Cancel')),
209 class: 'btn cbi-button cbi-button-positive important',
210 click: ui.createHandlerFn(this, function () {
211 this.handleInstall(sysupgrade_url, keep.checked, image.sha256);
214 _('Install firmware image')
219 ui.showModal(_('Successfully created firmware image'), modal_body);
220 if (data.rebuilder) {
221 this.handleRebuilder(content, data, firmware);
226 handle202: function (response) {
227 if ('queue_position' in response) {
228 ui.showModal(_('Queued...'), [
231 { class: 'spinning' },
232 _('Request in build queue position %s').format(
233 response.queue_position
238 ui.showModal(_('Building Firmware...'), [
241 { class: 'spinning' },
242 _('Progress: %s%% %s').format(
243 this.steps[response.imagebuilder_status][0],
244 this.steps[response.imagebuilder_status][1]
251 handleError: function (response, data, firmware, request_hash) {
252 response = response.json();
253 const request_data = {
255 request_hash: request_hash,
256 sha256_unsigned: this.sha256_unsigned,
264 { href: 'https://forum.openwrt.org/t/luci-attended-sysupgrade-support-thread/230552' },
265 _('this forum thread')
267 _('. If you don\'t find a solution there, report all of the information below.')
273 class: 'btn cbi-button cbi-button-positive important',
274 click: ui.createHandlerFn(this, function () {
275 // No translations in here as it's intended for the forum.
277 'Server response: %s'.format(response.detail)
279 + '`--version-to %s --device %s:%s`'.format(
280 request_data.version,
282 request_data.profile,
285 + '[details="Request Data"]\n'
287 + JSON.stringify({ ...request_data }, null, 4) + '\n'
291 if (response.stdout) {
293 '[details="STDOUT"]\n'
295 + response.stdout + '\n'
300 if (response.stderr) {
302 '[details="STDERR"]\n'
304 + response.stderr + '\n'
310 navigator.clipboard.writeText(text);
312 ui.showModal(_('Data copied!'), [
314 _('Paste the contents of the clipboard to '),
317 { href: 'https://forum.openwrt.org/t/luci-attended-sysupgrade-support-thread/230552' },
318 _('this forum thread')
321 E('div', { class: 'btn', click: ui.hideModal }, _('Close')),
325 _('Copy error data to clipboard')
328 E('p', {}, _('Server response: %s').format(response.detail)),
329 E('p', {}, _('Request Data:')),
330 E('pre', {}, JSON.stringify({ ...request_data }, null, 4)),
333 if (response.stdout) {
334 body.push(E('b', {}, 'STDOUT:'));
335 body.push(E('pre', {}, response.stdout));
338 if (response.stderr) {
339 body.push(E('b', {}, 'STDERR:'));
340 body.push(E('pre', {}, response.stderr));
344 E('div', { class: 'right' }, [
345 E('div', { class: 'btn', click: ui.hideModal }, _('Close')),
349 ui.showModal(_('Error building the firmware image'), body);
352 handleRequest: function (server, main, content, data, firmware) {
353 let request_url = `${server}/api/v1/build`;
355 let local_content = content;
356 const request_hash = this.request_hash.get(server);
359 * If `request_hash` is available use a GET request instead of
360 * sending the entire object.
363 request_url += `/${request_hash}`;
369 .request(request_url, { method: method, content: local_content })
370 .then((response) => {
371 switch (response.status) {
373 response = response.json();
375 this.request_hash.set(server, response.request_hash);
378 this.handle202(response);
380 let view = document.getElementById(server);
381 view.innerText = `⏳ (${
382 this.steps[response.imagebuilder_status][0]
388 poll.remove(this.pollFn);
389 this.handle200(response, content, data, firmware);
391 poll.remove(this.rebuilder_polls[server]);
392 response = response.json();
393 let view = document.getElementById(server);
394 let image = this.selectImage(response.images, data, firmware);
395 if (image.sha256_unsigned == this.sha256_unsigned) {
396 view.innerText = '✅ %s'.format(server);
398 view.innerHTML = `⚠️ ${server} (<a href="${server}/store/${
400 }/${image.name}">${_('Download')}</a>)`;
404 default: // any error or unexpected responses
406 poll.remove(this.pollFn);
407 this.handleError(response, data, firmware, request_hash);
409 poll.remove(this.rebuilder_polls[server]);
410 document.getElementById(server).innerText = '🚫 %s'.format(
419 handleRebuilder: function (content, data, firmware) {
420 this.rebuilder_polls = {};
421 for (let rebuilder of data.rebuilder) {
422 this.rebuilder_polls[rebuilder] = L.bind(
431 poll.add(this.rebuilder_polls[rebuilder], 5);
432 document.getElementById(
434 ).innerHTML += `<p id="${rebuilder}">⏳ ${rebuilder}</p>`;
439 handleInstall: function (url, keep, sha256) {
440 ui.showModal(_('Downloading...'), [
443 { class: 'spinning' },
444 _('Downloading firmware from server to browser')
451 'Content-Type': 'application/x-www-form-urlencoded',
453 responseType: 'blob',
455 .then((response) => {
456 let form_data = new FormData();
457 form_data.append('sessionid', rpc.getSessionID());
458 form_data.append('filename', '/tmp/firmware.bin');
459 form_data.append('filemode', 600);
460 form_data.append('filedata', response.blob());
462 ui.showModal(_('Uploading...'), [
465 { class: 'spinning' },
466 _('Uploading firmware from browser to device')
471 .get(`${L.env.cgi_base}/cgi-upload`, {
475 .then((response) => response.json())
476 .then((response) => {
477 if (response.sha256sum != sha256) {
478 ui.showModal(_('Wrong checksum'), [
481 _('Error during download of firmware. Please try again')
483 E('div', { class: 'btn', click: ui.hideModal }, _('Close')),
486 ui.showModal(_('Installing...'), [
489 { class: 'spinning' },
490 _('Installing the sysupgrade. Do not unpower device!')
494 L.resolveDefault(callUpgradeStart(keep), {}).then((response) => {
496 ui.awaitReconnect(window.location.host);
498 ui.awaitReconnect('192.168.1.1', 'openwrt.lan');
506 handleCheck: function (data, firmware) {
507 this.request_hash.clear();
508 let { url, revision, advanced_mode, branch } = data;
509 let { version, target, profile, packages } = firmware;
512 const endpoint = version.endsWith('SNAPSHOT') ? `revision/${version}/${target}` : 'overview';
513 const request_url = `${url}/api/v1/${endpoint}`;
515 ui.showModal(_('Searching...'), [
518 { class: 'spinning' },
519 _('Searching for an available sysupgrade of %s - %s').format(
526 L.resolveDefault(request.get(request_url)).then((response) => {
528 ui.showModal(_('Error connecting to upgrade server'), [
532 _('Could not reach API at "%s". Please try again later.').format(
536 E('pre', {}, response.responseText),
537 E('div', { class: 'right' }, [
538 E('div', { class: 'btn', click: ui.hideModal }, _('Close')),
543 if (version.endsWith('SNAPSHOT')) {
544 const remote_revision = response.json().revision;
546 get_revision_count(revision) < get_revision_count(remote_revision)
548 candidates.push([version, remote_revision]);
551 const latest = response.json().latest;
553 // ensure order: newest to oldest release
554 latest.sort().reverse();
556 for (let remote_version of latest) {
557 let remote_branch = get_branch(remote_version);
559 // already latest version installed
560 if (version == remote_version) {
564 candidates.unshift([remote_version, null]);
566 // don't offer branches older than the current
567 if (branch == remote_branch) {
573 // allow to re-install running firmware in advanced mode
574 if (advanced_mode == 1) {
575 candidates.unshift([version, revision]);
578 if (candidates.length) {
584 version: candidates[0][0],
585 packages: Object.keys(packages).sort(),
589 let map = new form.JSONMap(mapdata, '');
596 'Use defaults for the safest update'
598 o = s.option(form.ListValue, 'version', 'Select firmware version');
599 for (let candidate of candidates) {
600 if (candidate[0] == version && candidate[1] == revision) {
603 _('[installed] %s').format(
605 ? `${candidate[0]} - ${candidate[1]}`
612 candidate[1] ? `${candidate[0]} - ${candidate[1]}` : candidate[0]
617 if (advanced_mode == 1) {
618 o = s.option(form.Value, 'profile', _('Board Name / Profile'));
619 o = s.option(form.DynamicList, 'packages', _('Packages'));
622 L.resolveDefault(map.render()).then((form_rendered) => {
623 ui.showModal(_('New firmware upgrade available'), [
626 _('Currently running: %s - %s').format(
632 E('div', { class: 'right' }, [
633 E('div', { class: 'btn', click: ui.hideModal }, _('Cancel')),
638 class: 'btn cbi-button cbi-button-positive important',
639 click: ui.createHandlerFn(this, function () {
640 map.save().then(() => {
641 this.applyPackageChanges({
644 version: mapdata.request.version,
645 packages: mapdata.request.packages,
646 }).then((packages) => {
650 version: mapdata.request.version,
651 profile: mapdata.request.profile
653 this.pollFn = L.bind(function () {
654 this.handleRequest(url, true, content, data, firmware);
656 poll.add(this.pollFn, 5);
660 ui.addNotification(null, E('p', error.message));
666 _('Request firmware image')
672 ui.showModal(_('No upgrade available'), [
675 _('The device runs the latest firmware version %s - %s').format(
680 E('div', { class: 'right' }, [
681 E('div', { class: 'btn', click: ui.hideModal }, _('Close')),
688 load: async function () {
689 const promises = await Promise.all([
690 L.resolveDefault(callPackagelist(), {}),
691 L.resolveDefault(callSystemBoard(), {}),
692 L.resolveDefault(fs.stat('/sys/firmware/efi'), null),
693 uci.load('attendedsysupgrade'),
696 url: uci.get_first('attendedsysupgrade', 'server', 'url').replace(/\/+$/, ''),
697 branch: get_branch(promises[1].release.version),
698 revision: promises[1].release.revision,
700 advanced_mode: uci.get_first('attendedsysupgrade', 'client', 'advanced_mode') || 0,
701 rebuilder: uci.get_first('attendedsysupgrade', 'server', 'rebuilder')
704 client: 'luci/' + promises[0].packages['luci-app-attendedsysupgrade'],
705 packages: promises[0].packages,
706 profile: promises[1].board_name,
707 target: promises[1].release.target,
708 version: promises[1].release.version,
710 filesystem: promises[1].rootfs_type,
712 // If the user has changed the rootfs partition size via owut,
713 // then make sure to keep new image the same size. A null value
714 // is interpreted by the ASU server as "default".
715 rootfs_size_mb: uci.get('attendedsysupgrade', 'owut', 'rootfs_size'),
717 return [data, firmware];
720 render: function (response) {
721 const data = response[0];
722 const firmware = response[1];
725 E('h2', _('Attended Sysupgrade')),
729 'The attended sysupgrade service allows to upgrade vanilla and custom firmware images easily.'
735 'This is done by building a new firmware on demand via an online service.'
740 _('Currently running: %s - %s').format(
748 class: 'btn cbi-button cbi-button-positive important',
749 click: ui.createHandlerFn(this, this.handleCheck, data, firmware),
751 _('Search for firmware upgrade')
755 handleSaveApply: null,